Allocation
Create an allocation
새로운 캠페인과 지면 간의 배정을 생성합니다.
배정은 캠페인과 지면 간의 관계를 나타내며, 캠페인의 광고가 지면에 서비스되는 방식을 정의합니다.
액세스 제어:
- 관리자 및 리테일러 계정: 모든 캠페인/지면에 대한 배정을 생성할 수 있습니다.
- 광고주 계정: 소유한 캠페인에 대한 배정만 생성할 수 있습니다.
사용자가 캠페인을 생성할 권한이 없는 경우, 요청이 실패합니다.
POST
/
allocations
Create an allocation
curl --request POST \
--url https://your_a2_service/allocations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tagid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"crid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ext": {},
"last_comment": "",
"updated_at": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://your_a2_service/allocations"
payload = {
"owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tagid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"crid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ext": {},
"last_comment": "",
"updated_at": "2023-11-07T05:31:56Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
owner_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
tagid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
cid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
created_at: '2023-11-07T05:31:56Z',
crid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
ext: {},
last_comment: '',
updated_at: '2023-11-07T05:31:56Z'
})
};
fetch('https://your_a2_service/allocations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://your_a2_service/allocations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'owner_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'tagid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'cid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'created_at' => '2023-11-07T05:31:56Z',
'crid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'ext' => [
],
'last_comment' => '',
'updated_at' => '2023-11-07T05:31:56Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://your_a2_service/allocations"
payload := strings.NewReader("{\n \"owner_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tagid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"cid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"crid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"ext\": {},\n \"last_comment\": \"\",\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://your_a2_service/allocations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"owner_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tagid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"cid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"crid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"ext\": {},\n \"last_comment\": \"\",\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://your_a2_service/allocations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"owner_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tagid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"cid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"crid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"ext\": {},\n \"last_comment\": \"\",\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"no": 123,
"owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"tagid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"crid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ext": {},
"last_comment": "",
"updated_at": "2023-11-07T05:31:56Z"
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}인증
The access token received from the authorization server in the OAuth 2.0 flow.
본문
application/json
캠페인 개제 정보 생성을 위한 스키마
캠페인 개제 정보를 생성한 계정의 id
캠페인의 지면 게재 상태
사용 가능한 옵션:
pending, requested, published, rejected, canceled, finished 캠페인을 개제할 지면의 id
지면에 게재할 캠페인의 id
생성 일시
캠페인 게재 승인 과정에서 리테일러에 의해 작성된 가장 최근 의견
변경 일시
응답
Successful Response
캠페인 개제 정보 조회 스키마
캠페인 게재 정보 번호
캠페인 개제 정보를 생성한 계정의 id
캠페인의 현재 개제 상태 (pending, published, rejected 등)
캠페인을 개제할 지면의 id
지면에 게재할 캠페인의 id
생성 일시
캠페인 게재 승인 과정에서 리테일러에 의해 작성된 가장 최근 의견
변경 일시
이 페이지가 도움이 되었나요?
⌘I
Create an allocation
curl --request POST \
--url https://your_a2_service/allocations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tagid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"crid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ext": {},
"last_comment": "",
"updated_at": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://your_a2_service/allocations"
payload = {
"owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tagid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"crid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ext": {},
"last_comment": "",
"updated_at": "2023-11-07T05:31:56Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
owner_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
tagid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
cid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
created_at: '2023-11-07T05:31:56Z',
crid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
ext: {},
last_comment: '',
updated_at: '2023-11-07T05:31:56Z'
})
};
fetch('https://your_a2_service/allocations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://your_a2_service/allocations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'owner_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'tagid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'cid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'created_at' => '2023-11-07T05:31:56Z',
'crid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'ext' => [
],
'last_comment' => '',
'updated_at' => '2023-11-07T05:31:56Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://your_a2_service/allocations"
payload := strings.NewReader("{\n \"owner_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tagid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"cid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"crid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"ext\": {},\n \"last_comment\": \"\",\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://your_a2_service/allocations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"owner_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tagid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"cid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"crid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"ext\": {},\n \"last_comment\": \"\",\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://your_a2_service/allocations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"owner_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tagid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"cid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"crid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"ext\": {},\n \"last_comment\": \"\",\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"no": 123,
"owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"tagid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"crid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ext": {},
"last_comment": "",
"updated_at": "2023-11-07T05:31:56Z"
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}